Inside Macintosh: QuickDraw GX Printing /

Chapter 3 - Page Formatting and Dialog Box Customization / Page Formatting and Dialog Box Customization Reference

Application-Defined Functions / Message Override Functions for Customizing QuickDraw GX Dialog Boxes

GXHandlePanelEvent

QuickDraw GX sends the gxHandlePanelEvent message when an event happens in a panel. You can install an override function for the gxHandlePanelEvent message to handle panel events that cannot be handled using extended item list resources. Your override function must match the following formal declaration:

OSErr GXHandlePanelEvent (gxPanelInfoRecord *aPanelInfoRecord,
                           gxPanelResult *panelResult);

aPanelInfoRecord

A pointer to the panel information structure that supplies information to the panel about the current dialog box and panel event.

panelResult

On return, the result of handling the panel event.

function result

An error code. The value noErr indicates that the operation was successful.

DESCRIPTION

QuickDraw GX sends the gxHandlePanelEvent message to allow a panel to handle events associated with the dialog box. The result code returned by the panelResult parameter is either a value of type OSErr, or one of the following values:

gxPanelNoResult

The returned value does not currently have any meaning.

gxPanelCancelConfirmation

The user confirmed the panel, however, the panel handler discovers that the user entered an inappropriate value in the dialog box.

The default implementation of this message does nothing. You need to override this message if you add panels that cannot be handled using extended item list resources.

SPECIAL CONSIDERATIONS

You never send the gxHandlePanelEvent message yourself.

You always perform a total override of the gxHandlePanelEvent message, in which you handle any events of interest that occur in your panel.

RESULT CODES

gxSegmentLoadFailedErr	A required code segment could not be found, or there was not enough memory to load it.
gxPrUserAbortErr	The user has canceled printing.

Main | Page One | What's New | Apple Computer, Inc. | Find It | Contact Us | Help